<!DOCTYPE html>
<html lang="en-US">
    <head>
        <title>Hash::Ordered - A fast, pure-Perl ordered hash class - metacpan.org</title>
        <link rel="preload" as="fetch" href="https://metacpan.org/account/login_status" crossorigin="anonymous" />
        <link href="https://metacpan.org/_assets/b8ccceeed47a0652049703d99326a9cea4933443.css" rel="stylesheet" type="text/css">
        <script src="https://metacpan.org/_assets/6bfedafe2d7caa915b7d84f61b45936818e3242e.js" type="text/javascript" defer></script>
        <link rel="alternate" type="application/rss+xml" title="Recent CPAN Uploads of Hash-Ordered - MetaCPAN" href="https://metacpan.org/dist/Hash-Ordered/releases.rss" />
        <link rel="canonical" href="./Hash::Ordered.html" />
        <meta name="description" content="A fast, pure-Perl ordered hash class" />
        <meta name="viewport" content="width=device-width, initial-scale=1, maximum-scale=5">
        <link rel="shortcut icon" href="https://metacpan.org/static/icons/favicon.ico">
        <link rel="apple-touch-icon" sizes="152x152" href="https://metacpan.org/static/icons/apple-touch-icon.png">
        <link rel="search" href="https://metacpan.org/static/opensearch.xml" type="application/opensearchdescription+xml" title="MetaCPAN">
        <script>
          (function(i,s,o,g,r,a,m){i['GoogleAnalyticsObject']=r;i[r]=i[r]||function(){
          (i[r].q=i[r].q||[]).push(arguments)},i[r].l=1*new Date();a=s.createElement(o),
          m=s.getElementsByTagName(o)[0];a.async=1;a.src=g;m.parentNode.insertBefore(a,m)
          })(window,document,'script','//www.google-analytics.com/analytics.js','ga');

          (function(skey, ga_id){
            ga('create', ga_id, {
              siteSpeedSampleRate : 100,
              storage             : 'none',
              clientId            : localStorage.getItem(skey)
            });
            ga(function(tracker) {
              localStorage.setItem(skey, tracker.get('clientId'));
            });
            ga('send', 'pageview');
          })('ga:clientId', 'UA-27829474-1');
        </script>
<meta name="twitter:card"        content="summary" />
<meta name="twitter:url"         content="https://metacpan.org/pod/Hash::Ordered" />
<meta name="twitter:title"       content="Hash::Ordered" />
<meta name="twitter:description" content="A fast, pure-Perl ordered hash class" />
<meta name="twitter:site"        content="metacpan" />
    </head>
    <body>
        <nav class="navbar navbar-default" role="navigation">
            <div class="header-logo-large hidden-xs">
              <a href="https://metacpan.org/" tabindex="0">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#logo" />
                </svg>
              </a>
            </div>
            <div class="header-logo-icon visible-xs">
              <a href="https://metacpan.org/">
                <svg class="logo" aria-label="MetaCPAN">
                  <use class="logo" href="/static/images/metacpan-logo.svg#dots" />
                </svg>
              </a>
            </div>
            <ul class="nav navbar-nav menu-items hidden-xs hidden-sm">
              <li><a href="https://metacpan.org/about">About</a></li>
              <li><a href="https://metacpan.org/about/sponsors">Sponsor</a></li>
              <li><a href="https://grep.metacpan.org/">grep::cpan</a></li>
              <li><a href="https://metacpan.org/recent">Recent</a></li>
              <li><a href="https://metacpan.org/about/faq">FAQ</a></li>
              <li><a href="https://metacpan.org/tools">Tools</a></li>
              <li><a href="https://fastapi.metacpan.org/">API</a></li>
            </ul>
            <ul class="nav navbar-nav navbar-right">
                <button type="button" class="searchbar-btn visible-xs visible-sm">
                    <i class="fa fa-search button-fa-icon"></i>
                </button>
                <form action="https://metacpan.org/search" class="searchbar-form visible-md visible-lg search-form form-horizontal">
                   <input type="hidden" name="size" id="metacpan_search-size" value="20">
                  <div class="form-group">
                      <div class="search-group">
                        <i class="fa fa-search"></i>
                        <input type="text" name="q" placeholder="Search the CPAN" size="41" autocorrect="off" autocapitalize="off" spellcheck="false" id="metacpan_search-input" class="form-control" value="">
                      </div>
                  </div>
                </form>
                    <li class="icon-slidepanel visible-xs visible-sm">
                      <button data-toggle="slidepanel" data-target=".slidepanel">
                        <span class="button-fa-icon">
                          <i class="fa fa-bars slidepanel-open"></i>
                          <i class="fa fa-times slidepanel-close"></i>
                        </span>
                      </button>
                    </li>
                <form action="https://metacpan.org/account/logout" method="POST" id="metacpan-logout"></form>
                <li class="dropdown logged_in" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon logged-in-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li><a href="https://metacpan.org/account/identities">Identities</a></li>
                        <li><a href="https://metacpan.org/account/profile">Profile</a></li>
                        <li><a href="https://metacpan.org/account/favorite/list">Favorites</a></li>
                        <li>
                            <a href="./Hash::Ordered.html#" type="button" onclick="$('#metacpan-logout').submit(); return false">
                              Logout
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_out" style="display: none;">
                    <button type="button" class="dropdown-toggle" data-toggle="dropdown">
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                      <i class="fas fa-chevron-down"></i>
                    </button>
                    <ul class="dropdown-menu">
                        <li>
                            <a href="https://metacpan.org/login/github">
                                <i class="fab fa-github fa-fw"></i>
                                GitHub
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/twitter">
                                <i class="fab fa-twitter fa-fw"></i>
                                Twitter
                            </a>
                        </li>
                        <li>
                            <a href="https://metacpan.org/login/google">
                                <i class="fab fa-google fa-fw"></i>
                                Google
                            </a>
                        </li>
                    </ul>
                </li>
                <li class="dropdown logged_placeholder">
                    <button>
                      <i class="fa fa-user button-fa-icon" aria-hidden="true"></i>
                    </button>
                </li>
            </ul>
        </nav>
        <div class="page-content ">
          <!--
          <div class="top-notify-banner">
            <i class="fas fa-info-circle"></i>
          </div>
          -->
          <nav class="sidebar">
            <div class="slidepanel">
              <ul class="nav-list ">
    <li class="nav-header no-margin-top">
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The date that this version of Hash-Ordered was released.">
      <span class="relatize">08 Jul 2019 13:25:02 UTC</span>
    </li>
  <li>
    Distribution: <a href="https://metacpan.org/dist/Hash-Ordered">Hash-Ordered</a>
  </li>
  <li>
    Module version: 0.014
  </li>
  <li>
    <a data-keyboard-shortcut="g s" href="https://metacpan.org/dist/Hash-Ordered/source/lib/Hash/Ordered.pm">Source</a>
    (<a href="https://metacpan.org/dist/Hash-Ordered/source/lib/Hash/Ordered.pm?raw=1">raw</a>)
  </li>
  <li>
    <a data-keyboard-shortcut="g b" href="https://metacpan.org/dist/Hash-Ordered/source/lib/Hash">Browse</a>
    (<a href="https://metacpan.org/dist/Hash-Ordered/source/lib/Hash?raw=1">raw</a>)
  </li>
    <li>
      <a data-keyboard-shortcut="g c" href="https://metacpan.org/dist/Hash-Ordered/changes">Changes</a>
    </li>
    <li>
      <a rel="noopener nofollow" class="nopopup" href="https://github.com/dagolden/Hash-Ordered">Homepage</a>
    </li>
    <li>
      <a class="nopopup" href="https://metacpan.org/dist/Hash-Ordered/contribute">How to Contribute</a>
    </li>
    <li>
        <a rel="noopener nofollow" data-keyboard-shortcut="g r" href="https://github.com/dagolden/Hash-Ordered">Repository</a>
    </li>
    <li>
      <a rel="noopener nofollow" data-keyboard-shortcut="g i" href="https://github.com/dagolden/Hash-Ordered/issues">Issues</a>
      (4)
    </li>
    <li>
      <a rel="noopener nofollow" href="http://matrix.cpantesters.org/?dist=Hash-Ordered+0.014" title="Matrix">Testers</a>
        <span title="(pass / fail / na)">(<a rel="noopener nofollow" href="https://www.cpantesters.org/distro/H/Hash-Ordered.html?oncpan=1&amp;distmat=1&amp;version=0.014&amp;grade=2" style="color: #090">4290</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/H/Hash-Ordered.html?oncpan=1&amp;distmat=1&amp;version=0.014&amp;grade=3" style="color: #900">0</a> / <a rel="noopener nofollow" href="https://www.cpantesters.org/distro/H/Hash-Ordered.html?oncpan=1&amp;distmat=1&amp;version=0.014&amp;grade=4">0</a>)</span>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpants.cpanauthors.org/release/DAGOLDEN/Hash-Ordered-0.014">Kwalitee</a>
    </li>
    <li>
      <div class="ttip" data-toggle="tooltip" data-placement="bottom" title="The # people with an indexing permission on Hash-Ordered who have released something to CPAN in the last 2 years (i.e. the # people likely able to release critical fixes in a timely manner)">
      Bus factor: 1
      </div>
    </li>
    <li>
      <a rel="noopener nofollow" href="http://cpancover.com/latest/Hash-Ordered-0.014/index.html">96.62% Coverage </a>
    </li>
    <li>
      License: apache_2_0
    </li>
    <li>
      Perl: v5.8.0
    </li>
    <li class="nav-header">Activity</li>
    <li>
<div class="activity-graph">
    <img src="https://metacpan.org/dist/Hash-Ordered/activity.svg?res=month" />
    <div class="comment">24 month</div>
</div>
    </li>
    <li class="nav-header">Tools</li>
    <li>
      <a itemprop="downloadUrl" href="https://cpan.metacpan.org/authors/id/D/DA/DAGOLDEN/Hash-Ordered-0.014.tar.gz">
      Download (<span itemprop="fileSize">35.97KB</span>)</a>
    </li>
    <li>
      <a href="https://explorer.metacpan.org/?url=%2Fmodule%2FDAGOLDEN%2FHash-Ordered-0.014%2Flib%2FHash%2FOrdered.pm">
        MetaCPAN Explorer
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/Hash-Ordered/permissions">
        Permissions
      </a>
    </li>
    <li>
      <a href="https://metacpan.org/dist/Hash-Ordered/releases.rss">
        Subscribe to distribution
      </a>
    </li>
    <li>
      <button class="btn btn-link" data-toggle="modal" data-target="#metacpan_install-instructions-dialog">
        Install Instructions
      </button>
    </li>
    <li>
      <form action="https://metacpan.org/search">
        <input type="hidden" name="q" value="dist:Hash-Ordered">
        <input type="search" name="q" placeholder="Search distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
      </form>
    </li>
    <li>
      <form action="https://grep.metacpan.org/search">
        <input type="hidden" name="qd" value="Hash-Ordered">
        <input type="hidden" name="source" value="metacpan">
        <input type="search" name="q" placeholder="grep distribution" class="form-control tool-bar-form">
        <input type="submit" style="display: none">
     </form>
    </li>
    <li class="version-jump">
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/lib/Hash/Ordered.pm&#39;" class="form-control tool-bar-form">
  <option disabled selected>Jump to version</option>
<option
  disabled
  value="DAGOLDEN/Hash-Ordered-0.014"
>0.014
  (DAGOLDEN on 2019-07-08)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.013-TRIAL"
>0.013-TRIAL DEV
  (DAGOLDEN on 2019-07-03)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.012"
>0.012
  (DAGOLDEN on 2017-03-09)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.011-TRIAL"
>0.011-TRIAL DEV
  (DAGOLDEN on 2017-03-04)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.010"
>0.010
  (DAGOLDEN on 2016-02-02)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.009"
>0.009
  (DAGOLDEN on 2015-05-05)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.008"
>0.008
  (DAGOLDEN on 2015-05-05)</option>
<optgroup label="BackPAN">'
<option
  
  value="DAGOLDEN/Hash-Ordered-0.007"
>0.007
  (DAGOLDEN on 2015-05-04)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.006"
>0.006
  (DAGOLDEN on 2015-05-04)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.005-TRIAL"
>0.005-TRIAL DEV
  (DAGOLDEN on 2015-05-01)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.004"
>0.004
  (DAGOLDEN on 2015-04-24)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.003-TRIAL"
>0.003-TRIAL DEV
  (DAGOLDEN on 2015-04-19)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.002"
>0.002
  (DAGOLDEN on 2014-07-05)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.001"
>0.001
  (DAGOLDEN on 2014-07-02)</option>
</optgroup>
</select>
    </li>
    <li class="version-diff">
<select onchange="document.location.href='/release/DAGOLDEN/Hash-Ordered-0.014/diff/' + encodeURIComponent(this.value) + '/lib/Hash/Ordered.pm'
" class="form-control tool-bar-form">
  <option disabled selected>Diff with version</option>
<option
  disabled
  value="DAGOLDEN/Hash-Ordered-0.014"
>0.014
  (DAGOLDEN on 2019-07-08)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.013-TRIAL"
>0.013-TRIAL DEV
  (DAGOLDEN on 2019-07-03)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.012"
>0.012
  (DAGOLDEN on 2017-03-09)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.011-TRIAL"
>0.011-TRIAL DEV
  (DAGOLDEN on 2017-03-04)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.010"
>0.010
  (DAGOLDEN on 2016-02-02)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.009"
>0.009
  (DAGOLDEN on 2015-05-05)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.008"
>0.008
  (DAGOLDEN on 2015-05-05)</option>
<optgroup label="BackPAN">'
<option
  
  value="DAGOLDEN/Hash-Ordered-0.007"
>0.007
  (DAGOLDEN on 2015-05-04)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.006"
>0.006
  (DAGOLDEN on 2015-05-04)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.005-TRIAL"
>0.005-TRIAL DEV
  (DAGOLDEN on 2015-05-01)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.004"
>0.004
  (DAGOLDEN on 2015-04-24)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.003-TRIAL"
>0.003-TRIAL DEV
  (DAGOLDEN on 2015-04-19)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.002"
>0.002
  (DAGOLDEN on 2014-07-05)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.001"
>0.001
  (DAGOLDEN on 2014-07-02)</option>
</optgroup>
</select>
    </li>

    <li>
<ul class="dependencies">
  <li class="nav-header">Dependencies</li>
  <li><a href="https://metacpan.org/pod/Carp" title="Carp" class="ellipsis">Carp</a></li>
  <li><a href="https://metacpan.org/pod/constant" title="constant" class="ellipsis">constant</a></li>
  <li><a href="https://metacpan.org/pod/overload" title="overload" class="ellipsis">overload</a></li>
  <li><a href="https://metacpan.org/pod/strict" title="strict" class="ellipsis">strict</a></li>
  <li><a href="https://metacpan.org/pod/warnings" title="warnings" class="ellipsis">warnings</a></li>
  <li>
    <hr>
  </li>
  <li>
    <a href="https://metacpan.org/module/Hash::Ordered/requires">Reverse dependencies</a>
  </li>
  <li>
    <a href="http://deps.cpantesters.org/?module=Hash%3A%3AOrdered">CPAN Testers List</a>
  </li>
  <li>
    <a href="https://cpandeps.grinnz.com/?dist=Hash-Ordered">Dependency graph</a>
  </li>
</ul>
    </li>
    <li class="nav-header">Permalinks</li>
    <li>
      <a href="https://metacpan.org/release/DAGOLDEN/Hash-Ordered-0.014/view/lib/Hash/Ordered.pm">This version</a>
    </li>
    <li>
      <a href="./Hash::Ordered.html">Latest version</a>
    </li>
    <li>
<div class="plussers">
<div class="nav-header">++ed by:</div>
<div>
<a class="display-all" href="https://metacpan.org/author/KARJALA"><img src="https://www.gravatar.com/avatar/9685932c4be47d9e6370f49230700c40?d=identicon&amp;s=20" title="KARJALA" alt="KARJALA"></a>
<a class="display-all" href="https://metacpan.org/author/DRAEGTUN"><img src="https://www.gravatar.com/avatar/6f1ae19bf6507a7bd1ea0d0f6abfeb01?d=identicon&amp;s=20" title="DRAEGTUN" alt="DRAEGTUN"></a>
<a class="display-all" href="https://metacpan.org/author/SKOLYCHEV"><img src="https://www.gravatar.com/avatar/bbf606ef8939c0c5ef9a83e883eeaf8f?d=identicon&amp;s=20" title="SKOLYCHEV" alt="SKOLYCHEV"></a>
<a class="display-all" href="https://metacpan.org/author/BINJOY"><img src="https://www.gravatar.com/avatar/fd4de3b71caea7fa4b305ad108e999e0?d=identicon&amp;s=20" title="BINJOY" alt="BINJOY"></a>
<a class="display-all" href="https://metacpan.org/author/DAGOLDEN"><img src="https://www.gravatar.com/avatar/bb755c989fcb9897f28a2c6e00df61e2?d=identicon&amp;s=20" title="DAGOLDEN" alt="DAGOLDEN"></a>
</div>
<!-- Display counts of plussers-->
<div>
    <a href="https://metacpan.org/dist/Hash-Ordered/plussers">20 PAUSE users</a>
</div>
<div>
    13 non-PAUSE users
</div>
</div>
    </li>
    <li>
<div id="metacpan_contributors">
  <div>
    <button class="btn-link"
      onclick="$(this).hide(); $('#metacpan_contributors ul').slideDown(); return false;"
    >and 3 contributors</button>
  </div>
  <ul style="display: none">
    <li class="contributor"
      data-cpan-author="PETDANCE"
      data-contrib-email="andy@petdance.com"
    >
      <a href="https://metacpan.org/author/PETDANCE" class="cpan-author">
      <img class="gravatar" width="20" height="20" src="https://www.gravatar.com/avatar/8077a0584e451732420d43f5d0b3bd31?d=identicon&amp;s=20" />
      Andy Lester
      </a>
    </li>
    <li class="contributor"
      data-cpan-author="BPJ"
      data-contrib-email="bpjonsson@gmail.com"
    >
      <a href="https://metacpan.org/author/BPJ" class="cpan-author">
      <img class="gravatar" width="20" height="20" src="https://www.gravatar.com/avatar/87a2b4b6569c0c8f606067704b64a3cb?d=identicon&amp;s=20" />
      Benct Philip Jonsson
      </a>
    </li>
    <li class="contributor"
      data-cpan-author="MARIOROY"
      data-contrib-email="marioeroy@gmail.com"
    >
      <a href="https://metacpan.org/author/MARIOROY" class="cpan-author">
      <img class="gravatar" width="20" height="20" src="https://www.gravatar.com/avatar/112c64e088284a78b9afbcb83c125613?d=identicon&amp;s=20" />
      Mario Roy
      </a>
    </li>
  </ul>
</div>
    </li>
              </ul>
            </div>
          </nav>
          <div class="content-navigation">
<div class="breadcrumbs">
  <span>
    <a data-keyboard-shortcut="g a" rel="author" href="https://metacpan.org/author/DAGOLDEN" class="author-name">David Golden</a>
  </span>
  <span>&nbsp;/&nbsp;</span>
  <div class="release dist-release status-latest maturity-released">
    <span class="dropdown"><b class="caret"></b></span>
<select onchange="document.location.href=&#39;/release/&#39;+this.value+&#39;/view/lib/Hash/Ordered.pm&#39;" class="">
<option
  selected
  value="DAGOLDEN/Hash-Ordered-0.014"
>0.014
  (DAGOLDEN on 2019-07-08)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.013-TRIAL"
>0.013-TRIAL DEV
  (DAGOLDEN on 2019-07-03)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.012"
>0.012
  (DAGOLDEN on 2017-03-09)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.011-TRIAL"
>0.011-TRIAL DEV
  (DAGOLDEN on 2017-03-04)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.010"
>0.010
  (DAGOLDEN on 2016-02-02)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.009"
>0.009
  (DAGOLDEN on 2015-05-05)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.008"
>0.008
  (DAGOLDEN on 2015-05-05)</option>
<optgroup label="BackPAN">'
<option
  
  value="DAGOLDEN/Hash-Ordered-0.007"
>0.007
  (DAGOLDEN on 2015-05-04)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.006"
>0.006
  (DAGOLDEN on 2015-05-04)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.005-TRIAL"
>0.005-TRIAL DEV
  (DAGOLDEN on 2015-05-01)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.004"
>0.004
  (DAGOLDEN on 2015-04-24)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.003-TRIAL"
>0.003-TRIAL DEV
  (DAGOLDEN on 2015-04-19)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.002"
>0.002
  (DAGOLDEN on 2014-07-05)</option>
<option
  
  value="DAGOLDEN/Hash-Ordered-0.001"
>0.001
  (DAGOLDEN on 2014-07-02)</option>
</optgroup>
</select>
    <a data-keyboard-shortcut="g d" class="release-name" href="https://metacpan.org/dist/Hash-Ordered">Hash-Ordered-0.014</a>
  </div>
<span class="river-gauge-gauge">
  <svg width="24px"
       height="15px"
       version="1.1"
       xmlns="http://www.w3.org/2000/svg"
       xmlns:xlink="http://www.w3.org/1999/xlink">

    <g>
      <title>        River stage two &#10;
          • 8 direct dependents &#10;          • 31 total dependents
      </title>

      <rect x="0"  y="0" width="4" height="15" fill="#7ea3f2" />
      <rect x="5"  y="0" width="4" height="15" fill="#7ea3f2" />
      <rect x="10"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="15"  y="0" width="4" height="15" fill="#e4e2e2" />
      <rect x="20"  y="0" width="4" height="15" fill="#e4e2e2" />
    </g>
  </svg>

</span>
<div id="Hash-Ordered-fav" class="logged_in">
<form action="https://metacpan.org/account/favorite/add" style="display: inline" onsubmit="return favDistribution(this)">
    <input type="hidden" name="remove" value="0">
    <input type="hidden" name="release" value="Hash-Ordered-0.014">
    <input type="hidden" name="author" value="DAGOLDEN">
    <input type="hidden" name="distribution" value="Hash-Ordered">
    <button type="submit" class="favorite highlight"><span>33</span> ++</button>
</form>
</div>
<div class="logged_out">
<a href="./Hash::Ordered.html" onclick="alert('Please sign in to add favorites'); return false" class="favorite highlight">
<span>33</span> ++</a>
</div>
   / <span>Hash::Ordered</span>
</div>
          </div>
          <main class="content">


<nav class="toc">
  <div class="toc-header"><strong>Contents</strong></div>
<ul>
  <li><a href="./Hash::Ordered.html#NAME">NAME</a></li>
  <li><a href="./Hash::Ordered.html#VERSION">VERSION</a></li>
  <li><a href="./Hash::Ordered.html#SYNOPSIS">SYNOPSIS</a></li>
  <li><a href="./Hash::Ordered.html#DESCRIPTION">DESCRIPTION</a></li>
  <li><a href="./Hash::Ordered.html#METHODS">METHODS</a>
    <ul>
      <li><a href="./Hash::Ordered.html#new">new</a></li>
      <li><a href="./Hash::Ordered.html#clone">clone</a></li>
      <li><a href="./Hash::Ordered.html#keys">keys</a></li>
      <li><a href="./Hash::Ordered.html#values">values</a></li>
      <li><a href="./Hash::Ordered.html#get">get</a></li>
      <li><a href="./Hash::Ordered.html#set">set</a></li>
      <li><a href="./Hash::Ordered.html#exists">exists</a></li>
      <li><a href="./Hash::Ordered.html#delete">delete</a></li>
      <li><a href="./Hash::Ordered.html#clear">clear</a></li>
      <li><a href="./Hash::Ordered.html#push">push</a></li>
      <li><a href="./Hash::Ordered.html#pop">pop</a></li>
      <li><a href="./Hash::Ordered.html#unshift">unshift</a></li>
      <li><a href="./Hash::Ordered.html#shift">shift</a></li>
      <li><a href="./Hash::Ordered.html#merge">merge</a></li>
      <li><a href="./Hash::Ordered.html#as_list">as_list</a></li>
      <li><a href="./Hash::Ordered.html#iterator">iterator</a></li>
      <li><a href="./Hash::Ordered.html#preinc">preinc</a></li>
      <li><a href="./Hash::Ordered.html#postinc">postinc</a></li>
      <li><a href="./Hash::Ordered.html#predec">predec</a></li>
      <li><a href="./Hash::Ordered.html#postdec">postdec</a></li>
      <li><a href="./Hash::Ordered.html#add">add</a></li>
      <li><a href="./Hash::Ordered.html#subtract">subtract</a></li>
      <li><a href="./Hash::Ordered.html#concat">concat</a></li>
      <li><a href="./Hash::Ordered.html#or_equals">or_equals</a></li>
      <li><a href="./Hash::Ordered.html#dor_equals">dor_equals</a></li>
    </ul>
  </li>
  <li><a href="./Hash::Ordered.html#OVERLOADING">OVERLOADING</a>
    <ul>
      <li><a href="./Hash::Ordered.html#Boolean">Boolean</a></li>
      <li><a href="./Hash::Ordered.html#String">String</a></li>
      <li><a href="./Hash::Ordered.html#Numeric">Numeric</a></li>
      <li><a href="./Hash::Ordered.html#Fallback">Fallback</a></li>
    </ul>
  </li>
  <li><a href="./Hash::Ordered.html#TIED-INTERFACE">TIED INTERFACE</a></li>
  <li><a href="./Hash::Ordered.html#CAVEATS">CAVEATS</a>
    <ul>
      <li><a href="./Hash::Ordered.html#Deletion-and-order-modification-with-push,-pop,-etc.">Deletion and order modification with push, pop, etc.</a></li>
    </ul>
  </li>
  <li><a href="./Hash::Ordered.html#MOTIVATION">MOTIVATION</a></li>
  <li><a href="./Hash::Ordered.html#SEE-ALSO">SEE ALSO</a>
    <ul>
      <li><a href="./Hash::Ordered.html#Tie-modules">Tie modules</a></li>
      <li><a href="./Hash::Ordered.html#Other-ordered-hash-modules">Other ordered hash modules</a></li>
    </ul>
  </li>
  <li><a href="./Hash::Ordered.html#SUPPORT">SUPPORT</a>
    <ul>
      <li><a href="./Hash::Ordered.html#Bugs-/-Feature-Requests">Bugs / Feature Requests</a></li>
      <li><a href="./Hash::Ordered.html#Source-Code">Source Code</a></li>
    </ul>
  </li>
  <li><a href="./Hash::Ordered.html#AUTHOR">AUTHOR</a></li>
  <li><a href="./Hash::Ordered.html#CONTRIBUTORS">CONTRIBUTORS</a></li>
  <li><a href="./Hash::Ordered.html#COPYRIGHT-AND-LICENSE">COPYRIGHT AND LICENSE</a></li>
</ul></nav>
<div class="pod anchors">
<h1 id="NAME">NAME</h1>

<p>Hash::Ordered - A fast, pure-Perl ordered hash class</p>

<h1 id="VERSION">VERSION</h1>

<p>version 0.014</p>

<h1 id="SYNOPSIS">SYNOPSIS</h1>

<pre><code>    use Hash::Ordered;

    my $oh = Hash::Ordered-&gt;new( a =&gt; 1 );

    $oh-&gt;get( &#39;a&#39; );
    $oh-&gt;set( &#39;a&#39; =&gt; 2 );

    $oh-&gt;exists( &#39;a&#39; );
    $val = $oh-&gt;delete( &#39;a&#39; );

    @keys  = $oh-&gt;keys;
    @vals  = $oh-&gt;values;
    @pairs = $oh-&gt;as_list

    $oh-&gt;push( c =&gt; 3, d =&gt; 4 );
    $oh-&gt;unshift( e =&gt; 5, f =&gt; 6 );

    ( $k, $v ) = $oh-&gt;pop;
    ( $k, $v ) = $oh-&gt;shift;

    $iter = $oh-&gt;iterator;
    while( ( $k, $v ) = $iter-&gt;() ) { ... }

    $copy     = $oh-&gt;clone;
    $subset   = $oh-&gt;clone( qw/c d/ );
    $reversed = $oh-&gt;clone( reverse $oh-&gt;keys );

    @value_slice = $oh-&gt;values(  qw/c f/ ); # qw/3 6/
    @pairs_slice = $oh-&gt;as_list( qw/f e/ ); # qw/f 6 e 5/

    $oh-&gt;postinc( &#39;a&#39; );          # like $oh{a}++
    $oh-&gt;add( &#39;a&#39;, 5 );           # like $oh{a} += 5
    $oh-&gt;concat( &#39;a&#39;, &#39;hello&#39; );  # like $oh{a} .= &#39;hello&#39;
    $oh-&gt;or_equals( &#39;g&#39;, &#39;23&#39; );  # like $oh{g} ||= 23
    $oh-&gt;dor_equals( &#39;g&#39;, &#39;23&#39; ); # like $oh{g} //= 23</code></pre>

<h1 id="DESCRIPTION">DESCRIPTION</h1>

<p>This module implements an ordered hash, meaning that it associates keys with values like a Perl hash, but keeps the keys in a consistent order. Because it is implemented as an object and manipulated with method calls, it is much slower than a Perl hash. This is the cost of keeping order.</p>

<p>However, compared to other <b>ordered</b> hash implementations, Hash::Ordered is optimized for getting and setting individual elements and is generally faster at most other tasks as well. For specific details, see <a href="https://metacpan.org/pod/distribution/Hash-Ordered/lib/Hash/Ordered/Benchmarks.pod">Hash::Ordered::Benchmarks</a>.</p>

<h1 id="METHODS">METHODS</h1>

<h2 id="new">new</h2>

<pre><code>    $oh = Hash::Ordered-&gt;new;
    $oh = Hash::Ordered-&gt;new( @pairs );</code></pre>

<p>Constructs an object, with an optional list of key-value pairs.</p>

<p>The position of a key corresponds to the first occurrence in the list, but the value will be updated if the key is seen more than once.</p>

<p>Current API available since 0.009.</p>

<h2 id="clone">clone</h2>

<pre><code>    $oh2 = $oh-&gt;clone;
    $oh2 = $oh-&gt;clone( @keys );</code></pre>

<p>Creates a shallow copy of an ordered hash object. If no arguments are given, it produces an exact copy. If a list of keys is given, the new object includes only those keys in the given order. Keys that aren&#39;t in the original will have the value <code>undef</code>.</p>

<h2 id="keys">keys</h2>

<pre><code>    @keys = $oh-&gt;keys;
    $size = $oh-&gt;keys;</code></pre>

<p>In list context, returns the ordered list of keys. In scalar context, returns the number of elements.</p>

<p>Current API available since 0.005.</p>

<h2 id="values">values</h2>

<pre><code>    @values = $oh-&gt;values;
    @values = $oh-&gt;values( @keys );</code></pre>

<p>Returns an ordered list of values. If no arguments are given, returns the ordered values of the entire hash. If a list of keys is given, returns values in order corresponding to those keys. If a key does not exist, <code>undef</code> will be returned for that value.</p>

<p>In scalar context, returns the number of elements.</p>

<p>Current API available since 0.006.</p>

<h2 id="get">get</h2>

<pre><code>    $value = $oh-&gt;get(&quot;some key&quot;);</code></pre>

<p>Returns the value associated with the key, or <code>undef</code> if it does not exist in the hash.</p>

<h2 id="set">set</h2>

<pre><code>    $oh-&gt;set(&quot;some key&quot; =&gt; &quot;some value&quot;);</code></pre>

<p>Associates a value with a key and returns the value. If the key does not already exist in the hash, it will be added at the end.</p>

<h2 id="exists">exists</h2>

<pre><code>    if ( $oh-&gt;exists(&quot;some key&quot;) ) { ... }</code></pre>

<p>Test if some key exists in the hash (without creating it).</p>

<h2 id="delete">delete</h2>

<pre><code>    $value = $oh-&gt;delete(&quot;some key&quot;);</code></pre>

<p>Removes a key-value pair from the hash and returns the value.</p>

<h2 id="clear">clear</h2>

<pre><code>    $oh-&gt;clear;</code></pre>

<p>Removes all key-value pairs from the hash. Returns undef in scalar context or an empty list in list context.</p>

<p>Current API available since 0.003.</p>

<h2 id="push">push</h2>

<pre><code>    $oh-&gt;push( one =&gt; 1, two =&gt; 2);</code></pre>

<p>Add a list of key-value pairs to the end of the ordered hash. If a key already exists in the hash, it will be deleted and re-inserted at the end with the new value.</p>

<p>Returns the number of keys after the push is complete.</p>

<h2 id="pop">pop</h2>

<pre><code>    ($key, $value) = $oh-&gt;pop;
    $value = $oh-&gt;pop;</code></pre>

<p>Removes and returns the last key-value pair in the ordered hash. In scalar context, only the value is returned. If the hash is empty, the returned key and value will be <code>undef</code>.</p>

<h2 id="unshift">unshift</h2>

<pre><code>    $oh-&gt;unshift( one =&gt; 1, two =&gt; 2 );</code></pre>

<p>Adds a list of key-value pairs to the beginning of the ordered hash. If a key already exists, it will be deleted and re-inserted at the beginning with the new value.</p>

<p>Returns the number of keys after the unshift is complete.</p>

<h2 id="shift">shift</h2>

<pre><code>    ($key, $value) = $oh-&gt;shift;
    $value = $oh-&gt;shift;</code></pre>

<p>Removes and returns the first key-value pair in the ordered hash. In scalar context, only the value is returned. If the hash is empty, the returned key and value will be <code>undef</code>.</p>

<h2 id="merge">merge</h2>

<pre><code>    $oh-&gt;merge( one =&gt; 1, two =&gt; 2 );</code></pre>

<p>Merges a list of key-value pairs into the ordered hash. If a key already exists, its value is replaced. Otherwise, the key-value pair is added at the end of the hash.</p>

<h2 id="as_list">as_list</h2>

<pre><code>    @pairs = $oh-&gt;as_list;
    @pairs = $oh-&gt;as_list( @keys );</code></pre>

<p>Returns an ordered list of key-value pairs. If no arguments are given, all pairs in the hash are returned. If a list of keys is given, the returned list includes only those key-value pairs in the given order. Keys that aren&#39;t in the original will have the value <code>undef</code>.</p>

<h2 id="iterator">iterator</h2>

<pre><code>    $iter = $oh-&gt;iterator;
    $iter = $oh-&gt;iterator( reverse $oh-&gt;keys ); # reverse

    while ( my ($key,$value) = $iter-&gt;() ) { ... }</code></pre>

<p>Returns a code reference that returns a single key-value pair (in order) on each invocation, or the empty list if all keys are visited.</p>

<p>If no arguments are given, the iterator walks the entire hash in order. If a list of keys is provided, the iterator walks the hash in that order. Unknown keys will return <code>undef</code>.</p>

<p>The list of keys to return is set when the iterator is generator. Keys added later will not be returned. Subsequently deleted keys will return <code>undef</code> for the value.</p>

<h2 id="preinc">preinc</h2>

<pre><code>    $oh-&gt;preinc($key);      # like ++$hash{$key}</code></pre>

<p>This method is sugar for incrementing a key without having to call <code>set</code> and <code>get</code> explicitly. It returns the new value.</p>

<p>Current API available since 0.005.</p>

<h2 id="postinc">postinc</h2>

<pre><code>    $oh-&gt;postinc($key);     # like $hash{$key}++</code></pre>

<p>This method is sugar for incrementing a key without having to call <code>set</code> and <code>get</code> explicitly. It returns the old value.</p>

<p>Current API available since 0.005.</p>

<h2 id="predec">predec</h2>

<pre><code>    $oh-&gt;predec($key);      # like --$hash{$key}</code></pre>

<p>This method is sugar for decrementing a key without having to call <code>set</code> and <code>get</code> explicitly. It returns the new value.</p>

<p>Current API available since 0.005.</p>

<h2 id="postdec">postdec</h2>

<pre><code>    $oh-&gt;postdec($key);      # like $hash{$key}--</code></pre>

<p>This method is sugar for decrementing a key without having to call <code>set</code> and <code>get</code> explicitly. It returns the old value.</p>

<p>Current API available since 0.005.</p>

<h2 id="add">add</h2>

<pre><code>    $oh-&gt;add($key, $n);     # like $hash{$key} += $n</code></pre>

<p>This method is sugar for adding a value to a key without having to call <code>set</code> and <code>get</code> explicitly. With no value to add, it is treated as &quot;0&quot;. It returns the new value.</p>

<p>Current API available since 0.005.</p>

<h2 id="subtract">subtract</h2>

<pre><code>    $oh-&gt;subtract($key, $n);  # like $hash{$key} -= $n</code></pre>

<p>This method is sugar for subtracting a value from a key without having to call <code>set</code> and <code>get</code> explicitly. With no value to subtract, it is treated as &quot;0&quot;. It returns the new value.</p>

<p>Current API available since 0.005.</p>

<h2 id="concat">concat</h2>

<pre><code>    $oh-&gt;concat($key, $str); # like $hash{$key} .= $str</code></pre>

<p>This method is sugar for concatenating a string onto the value of a key without having to call <code>set</code> and <code>get</code> explicitly. It returns the new value. If the value to append is not defined, no concatenation is done and no warning is given.</p>

<p>Current API available since 0.005.</p>

<h2 id="or_equals">or_equals</h2>

<pre><code>    $oh-&gt;or_equals($key, $str); # like $hash{$key} ||= $str</code></pre>

<p>This method is sugar for assigning to a key if the existing value is false without having to call <code>set</code> and <code>get</code> explicitly. It returns the new value.</p>

<p>Current API available since 0.005.</p>

<h2 id="dor_equals">dor_equals</h2>

<pre><code>    $oh-&gt;dor_equals($key, $str); # like $hash{$key} //= $str</code></pre>

<p>This method is sugar for assigning to a key if the existing value is not defined without having to call <code>set</code> and <code>get</code> explicitly. It returns the new value.</p>

<p>Current API available since 0.005.</p>

<h1 id="OVERLOADING">OVERLOADING</h1>

<h2 id="Boolean">Boolean</h2>

<pre><code>    if ( $oh ) { ... }</code></pre>

<p>When used in boolean context, a Hash::Ordered object is true if it has any entries and false otherwise.</p>

<h2 id="String">String</h2>

<pre><code>    say &quot;$oh&quot;;</code></pre>

<p>When used in string context, a Hash::Ordered object stringifies like typical Perl objects. E.g. <code>Hash::Ordered=ARRAY(0x7f815302cac0)</code></p>

<p>Current API available since 0.005.</p>

<h2 id="Numeric">Numeric</h2>

<pre><code>    $count = 0 + $oh;</code></pre>

<p>When used in numeric context, a Hash::Ordered object numifies as the decimal representation of its memory address, just like typical Perl objects. E.g. <code>140268162536552</code></p>

<p>For the number of keys, call the <a href="./Hash::Ordered.html#keys">&quot;keys&quot;</a> method in scalar context.</p>

<p>Current API available since 0.005.</p>

<h2 id="Fallback">Fallback</h2>

<p>Other <a href="https://metacpan.org/pod/overload">overload</a> methods are derived from these three, if possible.</p>

<h1 id="TIED-INTERFACE"><a id="TIED"></a>TIED INTERFACE</h1>

<p>Using <code>tie</code> is slower than using method calls directly. But for compatibility with libraries that can only take hashes, it&#39;s available if you really need it:</p>

<pre><code>    tie my %hash, &quot;Hash::Ordered&quot;, @pairs;</code></pre>

<p>If you want to access the underlying object for method calls, use <code>tied</code>:</p>

<pre><code>    tied( %hash )-&gt;unshift( @data );</code></pre>

<p>Tied hash API available since 0.005.</p>

<h1 id="CAVEATS">CAVEATS</h1>

<h2 id="Deletion-and-order-modification-with-push,-pop,-etc."><a id="Deletion"></a><a id="Deletion-and-order-modification-with-push--pop--etc"></a>Deletion and order modification with push, pop, etc.</h2>

<p>This can be expensive, as the ordered list of keys has to be updated. For small hashes with no more than 25 keys, keys are found and spliced out with linear search. As an optimization for larger hashes, the first change to the ordered list of keys will construct an index to the list of keys. Thereafter, removed keys will be marked with a &quot;tombstone&quot; record. Tombstones will be garbage collected whenever the number of tombstones exceeds the number of valid keys.</p>

<p>These internal implementation details largely shouldn&#39;t concern you. The important things to note are:</p>

<ul>

<li><p>The costs of efficient deletion are deferred until you need it</p>

</li>
<li><p>Deleting lots of keys will temporarily appear to leak memory until garbage collection occurs</p>

</li>
</ul>

<h1 id="MOTIVATION">MOTIVATION</h1>

<p>For a long time, I used <a href="./Tie::IxHash.html">Tie::IxHash</a> for ordered hashes, but I grew frustrated with things it lacked, like a cheap way to copy an IxHash object or a convenient iterator when not using the tied interface. As I looked at its implementation, it seemed more complex than I though it needed, with an extra level of indirection that slows data access.</p>

<p>Given that frustration, I started experimenting with the simplest thing I thought could work for an ordered hash: a hash of key-value pairs and an array with key order.</p>

<p>As I worked on this, I also started searching for other modules doing similar things. What I found fell broadly into two camps: modules based on tie (even if they offered an OO interface), and pure OO modules. They all either lacked features I deemed necessary or else seemed overly-complex in either implementation or API.</p>

<p>Hash::Ordered attempts to find the sweet spot with simple implementation, reasonably good efficiency for most common operations, and a rich, intuitive API.</p>

<p>After discussions with Mario Roy about the potential use of Hash::Ordered with <a href="https://metacpan.org/pod/MCE">MCE</a>, I optimized deletion of larger hashes and provided a tied interface for compatibility. Mario&#39;s suggestions and feedback about optimization were quite valuable. Thank you, Mario!</p>

<h1 id="SEE-ALSO"><a id="SEE"></a>SEE ALSO</h1>

<p>This section describes other ordered-hash modules I found on CPAN. For benchmarking results, see <a href="https://metacpan.org/pod/distribution/Hash-Ordered/lib/Hash/Ordered/Benchmarks.pod">Hash::Ordered::Benchmarks</a>.</p>

<h2 id="Tie-modules"><a id="Tie"></a>Tie modules</h2>

<p>The following modules offer some sort of tie interface. I don&#39;t like ties, in general, because of the extra indirection involved over a direct method call. Still, you can make any tied interface into a faster OO one with <code>tied</code>:</p>

<pre><code>    tied( %tied_hash )-&gt;FETCH($key);</code></pre>

<p><a href="https://metacpan.org/pod/Tie::Hash::Indexed">Tie::Hash::Indexed</a> is implemented in XS and thus seems promising if pure-Perl isn&#39;t a criterion; it generally fails tests on Perl 5.18 and above due to the hash randomization change. Despite being XS, it is slower than Hash::Ordered at everything exception creation and deletion.</p>

<p><a href="./Tie::IxHash.html">Tie::IxHash</a> is probably the most well known and includes an OO API. Given the performance problems it has, &quot;well known&quot; is the only real reason to use it.</p>

<p>These other modules below have very specific designs/limitations and I didn&#39;t find any of them suitable for general purpose use:</p>

<ul>

<li><p><a href="https://metacpan.org/pod/Tie::Array::AsHash">Tie::Array::AsHash</a> &mdash; array elements split with separator; tie API only</p>

</li>
<li><p><a href="https://metacpan.org/pod/Tie::Hash::Array">Tie::Hash::Array</a> &mdash; ordered alphabetically; tie API only</p>

</li>
<li><p><a href="https://metacpan.org/pod/Tie::InsertOrderHash">Tie::InsertOrderHash</a> &mdash; ordered by insertion; tie API only</p>

</li>
<li><p><a href="https://metacpan.org/pod/Tie::LLHash">Tie::LLHash</a> &mdash; linked-list implementation; quite slow</p>

</li>
<li><p><a href="https://metacpan.org/pod/Tie::StoredOrderHash">Tie::StoredOrderHash</a> &mdash; ordered by last update; tie API only</p>

</li>
</ul>

<h2 id="Other-ordered-hash-modules"><a id="Other"></a>Other ordered hash modules</h2>

<p>Other modules stick with an object-oriented API, with a wide variety of implementation approaches.</p>

<p><a href="https://metacpan.org/pod/Array::AsHash">Array::AsHash</a> is essentially an inverse implementation from Hash::Ordered. It keeps pairs in an array and uses a hash to index into the array. This indirection would already make hash-like operations slower, but the specific implementation makes it even worse, with abstractions and function calls that make getting or setting individual items up to 10x slower than Hash::Ordered.</p>

<p>However, <code>Array::AsHash</code> takes an arrayref to initialize, which is very fast and can return the list of pairs faster, too. If you mostly create and list out very large ordered hashes and very rarely touch individual entries, I think this could be something to very cautiously consider.</p>

<p>These other modules below have restrictions or particularly complicated implementations (often relying on <code>tie</code>) and thus I didn&#39;t think any of them really suitable for use:</p>

<ul>

<li><p><a href="https://metacpan.org/pod/Array::Assign">Array::Assign</a> &mdash; arrays with named access; restricted keys</p>

</li>
<li><p><a href="https://metacpan.org/pod/Array::OrdHash">Array::OrdHash</a> &mdash; overloads array/hash deref and uses internal tied data</p>

</li>
<li><p><a href="https://metacpan.org/pod/Data::Pairs">Data::Pairs</a> &mdash; array of key-value hashrefs; allows duplicate keys</p>

</li>
<li><p><a href="https://metacpan.org/pod/Data::OMap">Data::OMap</a> &mdash; array of key-value hashrefs; no duplicate keys</p>

</li>
<li><p><a href="https://metacpan.org/pod/Data::XHash">Data::XHash</a> &mdash; blessed, tied hashref with doubly-linked-list</p>

</li>
</ul>

<h1 id="SUPPORT">SUPPORT</h1>

<h2 id="Bugs-/-Feature-Requests"><a id="Bugs"></a><a id="Bugs---Feature-Requests"></a>Bugs / Feature Requests</h2>

<p>Please report any bugs or feature requests through the issue tracker at <a href="https://github.com/dagolden/Hash-Ordered/issues">https://github.com/dagolden/Hash-Ordered/issues</a>. You will be notified automatically of any progress on your issue.</p>

<h2 id="Source-Code"><a id="Source"></a>Source Code</h2>

<p>This is open source software. The code repository is available for public review and contribution under the terms of the license.</p>

<p><a href="https://github.com/dagolden/Hash-Ordered">https://github.com/dagolden/Hash-Ordered</a></p>

<pre><code>  git clone https://github.com/dagolden/Hash-Ordered.git</code></pre>

<h1 id="AUTHOR">AUTHOR</h1>

<p>David Golden &lt;dagolden@cpan.org&gt;</p>

<h1 id="CONTRIBUTORS">CONTRIBUTORS</h1>

<ul>

<li><p>Andy Lester &lt;andy@petdance.com&gt;</p>

</li>
<li><p>Benct Philip Jonsson &lt;bpjonsson@gmail.com&gt;</p>

</li>
<li><p>Mario Roy &lt;marioeroy@gmail.com&gt;</p>

</li>
</ul>

<h1 id="COPYRIGHT-AND-LICENSE"><a id="COPYRIGHT"></a>COPYRIGHT AND LICENSE</h1>

<p>This software is Copyright (c) 2014 by David Golden.</p>

<p>This is free software, licensed under:</p>

<pre><code>  The Apache License, Version 2.0, January 2004</code></pre></div>

<div id="metacpan_install-instructions-dialog" class="modal fade">
  <div class="modal-dialog">
    <div class="modal-content">
      <div class="modal-header">
        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
        <h4 class="modal-title">Module Install Instructions</h4>
      </div>
      <div class="modal-body">
        <p>To install Hash::Ordered, copy and paste the appropriate command in to your terminal.</p>
        <p><a href="https://metacpan.org/dist/App-cpanminus/view/bin/cpanm">cpanm</a></p>
        <pre><code>cpanm Hash::Ordered</code></pre>
        <p><a href="https://metacpan.org/pod/CPAN">CPAN shell</a></p>
        <pre><code>perl -MCPAN -e shell
install Hash::Ordered</code></pre>
        <p>For more information on module installation, please visit <a href="https://www.cpan.org/modules/INSTALL.html">the detailed CPAN module installation guide</a>.</p>
      </div>
      <div class="modal-footer">
        <a href="./Hash::Ordered.html#" data-dismiss="modal" class="btn">Close</a>
      </div>
    </div>
  </div>
</div>
          </main>
          <div class="content-pagination">
          </div>
        </div>
        <footer class="footer">
          <div class="footer-container">
            <div class="footer-social">
              <div class="footer-link footer-logo">
                <a href="https://metacpan.org/">
                  <img src="https://metacpan.org/static/images/metacpan-logo.svg" alt="MetaCPAN" />
                </a>
              </div>
              <a class="footer-social-link" href="https://github.com/metacpan">
                <i class="fab fa-github-square"></i>
              </a>
              <a class="footer-social-link" href="https://fosstodon.org/@metacpan">
                <i class="fab fa-mastodon"></i>
              </a>
            </div>
            <div class="footer-links">
              <div class="footer-link">
                  <a href="https://metacpan.org/about">About</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/sponsors">Sponsor</a>
              </div>
              <div class="footer-link">
                  <a href="https://grep.metacpan.org">grep::cpan</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/recent">Recent</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/about/faq">FAQ</a>
              </div>
              <div class="footer-link">
                  <a href="https://metacpan.org/tools">Tools</a>
              </div>
              <div class="footer-link">
                  <a href="https://fastapi.metacpan.org/">API</a>
              </div>
              <div class="footer-link">
                  <a href="https://www.perl.org/">Perl.org</a>
              </div>
            </div>
            <div class="footer-sponsors">
              <a class="footer-sponsor-link" target="_blank" href="https://www.bytemark.co.uk/" rel="noopener">
                <img class="footer-sponsor-bytemark" src="https://metacpan.org/static/images/sponsors/bytemark_logo.svg" alt="Bytemark logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.liquidweb.com/" rel="noopener">
                <img class="footer-sponsor-liquidweb" src="https://metacpan.org/static/images/sponsors/liquidweb_logo.png" alt="liquidweb logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://deriv.com/careers/" rel="noopener">
                <img class="footer-sponsor-deriv" src="https://metacpan.org/static/images/sponsors/deriv.svg" alt="Deriv logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://geocode.xyz" rel="noopener">
                <img class="footer-sponsor-geocode" src="https://metacpan.org/static/images/sponsors/geocodelogo.svg" alt="Geocode logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://www.fastly.com/" rel="noopener">
                <img class="footer-sponsor-fastly" src="https://metacpan.org/static/images/sponsors/fastly_logo.svg" alt="Fastly logo">
              </a>
              <a class="footer-sponsor-link" target="_blank" href="https://opencagedata.com" rel="noopener">
                <img class="footer-sponsor-opencage" src="https://metacpan.org/static/images/sponsors/open-cage.svg" alt="OpenCage logo">
              </a>
            </div>
          </div>
        </footer>
        <div class="modal fade" tabindex="-1" role="dialog" id="metacpan_keyboard-shortcuts">
          <div class="modal-dialog">
            <div class="modal-content">
              <div class="modal-header">
                <button type="button" class="close" data-dismiss="modal">&times;</button>
                <h4 class="modal-title">Keyboard Shortcuts</h4>
              </div>
              <div class="modal-body row">
<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Global</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>s</kbd>
        </td>
        <td>Focus search bar</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>?</kbd>
        </td>
        <td>Bring up this help dialog</td>
      </tr>
    </tbody>
  </table>

  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>GitHub</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>p</kbd>
        </td>
        <td>Go to pull requests</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>go to github issues (only if github is preferred repository)</td>
      </tr>
    </tbody>
  </table>
</div>

<div class="col-md-6">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>POD</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>a</kbd>
        </td>
        <td>Go to author</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>c</kbd>
        </td>
        <td>Go to changes</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>i</kbd>
        </td>
        <td>Go to issues</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>d</kbd>
        </td>
        <td>Go to dist</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>r</kbd>
        </td>
        <td>Go to repository/SCM</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>s</kbd>
        </td>
        <td>Go to source</td>
      </tr>
      <tr>
        <td class="keys">
          <kbd>g</kbd> <kbd>b</kbd>
        </td>
        <td>Go to file browse</td>
      </tr>

    </tbody>
  </table>
</div>

<div class="col-md-12">
  <table class="table keyboard-shortcuts">
    <thead>
      <tr>
        <th></th>
        <th>Search terms</th>
      </tr>
    </thead>
    <tbody>
      <tr>
        <td><em>module:</em> (e.g. <a href="https://metacpan.org/search?q=module%3APlugin">module:Plugin</a>)</td>
      </tr>
      <tr>
        <td><em>distribution:</em> (e.g. <a href="https://metacpan.org/search?q=distribution%3ADancer+auth">distribution:Dancer auth</a>)</td>
      </tr>
      <tr>
        <td><em>author:</em> (e.g. <a href="https://metacpan.org/search?q=author%3ASONGMU+Redis">author:SONGMU Redis</a>)</td>
      </tr>
      <tr>
        <td><em>version:</em> (e.g. <a href="https://metacpan.org/search?q=version%3A1.00">version:1.00</a>)</td>
      </tr>
    </tbody>
  </table>
</div>
              </div>
              <div class="modal-footer"></div>
            </div>
          </div>
        </div>
    </body>
</html>
